ライン

折れ線グラフは、データ ポイントを直線上にプロットする方法です。多くの場合、傾向データ、または 2 つのデータセットの比較を表示するために使用されます。

使用例

var myLineChart = new Chart(ctx, {
    type: 'line',
    data: data,
    options: options
});

データセットのプロパティ

折れ線グラフを使用すると、データセットごとにいくつかのプロパティを指定できます。これらは、特定のデータセットの表示プロパティを設定するために使用されます。たとえば、線の色は一般的にこのように設定されます。

名前 タイプ スクリプト可能 インデックス可能 デフォルト
backgroundColor Color はい - 'rgba(0, 0, 0, 0.1)'
borderCapStyle string はい - 'butt'
borderColor Color はい - 'rgba(0, 0, 0, 0.1)'
borderDash number[] はい - []
borderDashOffset number はい - 0.0
borderJoinStyle string はい - 'miter'
borderWidth number はい - 3
cubicInterpolationMode string はい - 'default'
clip number|object - - borderWidth / 2
fill boolean|string はい - true
hoverBackgroundColor Color はい - undefined
hoverBorderCapStyle string はい - undefined
hoverBorderColor Color はい - undefined
hoverBorderDash number[] はい - undefined
hoverBorderDashOffset number はい - undefined
hoverBorderJoinStyle string はい - undefined
hoverBorderWidth number はい - undefined
label string - - ''
lineTension number - - 0.4
order number - - 0
pointBackgroundColor Color はい はい 'rgba(0, 0, 0, 0.1)'
pointBorderColor Color はい はい 'rgba(0, 0, 0, 0.1)'
pointBorderWidth number はい はい 1
pointHitRadius number はい はい 1
pointHoverBackgroundColor Color はい はい undefined
pointHoverBorderColor Color はい はい undefined
pointHoverBorderWidth number はい はい 1
pointHoverRadius number はい はい 4
pointRadius number はい はい 3
pointRotation number はい はい 0
pointStyle string|Image はい はい 'circle'
showLine boolean - - undefined
spanGaps boolean - - undefined
steppedLine boolean|string - - false
xAxisID string - - 最初の X 軸
yAxisID string - - 最初の y 軸

全般的

名前 説明
label 凡例とツールヒントに表示されるデータセットのラベル。
order データセットの描画順序。積み重ね、ツールチップ、凡例の順序にも影響します。
xAxisID このデータセットをプロットする X 軸の ID。
yAxisID このデータセットをプロットする y 軸の ID。

ポイントスタイリング

各ポイントのスタイルは、次のプロパティで制御できます。

名前 説明
pointBackgroundColor ポイントの塗りつぶしの色。
pointBorderColor ポイントの境界線の色。
pointBorderWidth ポイントの境界線の幅 (ピクセル単位)。
pointHitRadius マウス イベントに反応する非表示ポイントのピクセル サイズ。
pointRadius ポイントシェイプの半径。 0 に設定すると、ポイントはレンダリングされません。
pointRotation 点の回転 (度単位)。
pointStyle ポイントのスタイル。もっと...

これらすべての値がundefined、最初にデータセット オプションにフォールバックし、次に関連するオプションにフォールバックします。elements.point.*オプション。

ラインのスタイリング

線のスタイルは、次のプロパティで制御できます。

名前 説明
backgroundColor 線の塗りつぶしの色。
borderCapStyle ラインのキャップスタイル。見るMDN。
borderColor 線の色です。
borderDash ダッシュの長さと間隔。見るMDN。
borderDashOffset 破線のオフセット。見るMDN。
borderJoinStyle ラインジョイントスタイル。見るMDN。
borderWidth 線幅 (ピクセル単位)。
clip chartArea を基準にしてクリップする方法。正の値ではオーバーフローが許可され、負の値では chartArea 内の多くのピクセルがクリップされます。0= chartArea でクリップします。クリッピングは側面ごとに構成することもできます。clip: {left: 5, top: false, right: -2, bottom: 0}
fill 線の下の領域を埋める方法。見る面グラフ
lineTension 線のベジェ曲線の張力。直線を描画するには 0 に設定します。モノトーン 3 次補間が使用される場合、このオプションは無視されます。
showLine false の場合、このデータセットに対して線は描画されません。
spanGaps true の場合、データがないか null のデータを持つ点の間に線が描画されます。 false の場合は、NaNデータにより行に切れ目が作成されます。

値がundefinedshowLinespanGaps関連するものへのフォールバックチャート構成オプション。残りの値は、関連する値にフォールバックされます。elements.line.*オプション。

インタラクション

各ポイントとの相互作用は、次のプロパティで制御できます。

名前 説明
pointHoverBackgroundColor ホバー時のポイントの背景色。
pointHoverBorderColor ホバーしたときのポイントの境界線の色。
pointHoverBorderWidth ホバー時のポイントの境界線の幅。
pointHoverRadius ホバー時のポイントの半径。

三次補間モード

次の補間モードがサポートされています。

  • 'default'
  • 'monotone'

'default'アルゴリズムはカスタムの重み付け三次補間を使用し、あらゆる種類のデータセットに対して快適な曲線を生成します。

'monotone'アルゴリズムの方が適していますy = f(x)datasets : 内挿されるデータセットの単調性 (または区分的単調性) を保持し、局所的な極値 (存在する場合) が入力データ点に留まるようにします。

そのまま放置しておくと(undefined)、グローバルoptions.elements.line.cubicInterpolationModeプロパティが使用されます。

階段状のライン

次の値がサポートされていますsteppedLine

  • false: ステップ補間なし (デフォルト)
  • true: 補間前のステップ (eq.'before')
  • 'before': 補間の前段階
  • 'after': 補間後のステップ
  • 'middle': ステップ中間補間

もしsteppedLine値が false 以外に設定されている場合、lineTension無視されます。

構成オプション

折れ線グラフは次の構成オプションを定義します。これらのオプションは、グローバル チャート構成オプションとマージされます。Chart.defaults.global、チャートに渡されるオプションを形成します。

名前 タイプ デフォルト 説明
showLines boolean true false の場合、点間の線は描画されません。
spanGaps boolean false false の場合、NaN データにより行が中断されます。

デフォルトのオプション

作成されたすべての折れ線グラフに構成設定を適用することが一般的です。グローバル折れ線グラフ設定は次の場所に保存されます。Chart.defaults.line。グローバル オプションを変更すると、変更後に作成されたグラフにのみ影響します。既存のチャートは変更されません。

たとえば、すべての折れ線グラフを次のように設定するには、spanGaps = trueあなたならこうします:

Chart.defaults.line.spanGaps = true;

データ構造

data折れ線グラフのデータセットのプロパティは 2 つの形式で渡すことができます。

番号[]

data: [20, 10]

ときdataarray は数値の配列であり、通常、x 軸はカテゴリー。点は、配列内の位置を使用して軸上に配置されます。カテゴリ軸を使用して折れ線グラフを作成すると、labelsデータオブジェクトのプロパティを指定する必要があります。

点[]

data: [{
    x: 10,
    y: 20
}, {
    x: 15,
    y: 10
}]

この代替データセットは、次のような疎なデータセットに使用されます。散布図。各データ ポイントは、次の内容を含むオブジェクトを使用して指定されます。xyプロパティ。

積み上げ面グラフ

y 軸の設定を変更して積み上げを有効にすることで、折れ線グラフを積み上げ面グラフに構成できます。積み上げ面グラフを使用すると、1 つのデータ傾向が多数の小さな部分からどのように構成されているかを示すことができます。

var stackedLine = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        scales: {
            yAxes: [{
                stacked: true
            }]
        }
    }
});

「」と一致する結果

    「」に一致する結果はありません